home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / MouseBlanker / Mausweg.dok < prev    next >
Text File  |  1996-09-26  |  13KB  |  309 lines
  1.  
  2.                                Mausweg
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. -----------------------------
  20. Mausweg  ist  ein Commodity, das den Mauspfeil verschwinden läßt, wenn
  21. die  Maus  eine  bestimmte Zeit nicht mehr bewegt wurde oder wenn eine
  22. bestimmte  Anzahl  von  Tasten der Tastatur gedrückt wurde.  Der Pfeil
  23. erscheint  wieder, sobald Sie die Maus bewegen.  Damit soll verhindert
  24. werden, daß der Mauspfeil Informationen verdeckt.
  25.  
  26. Bei Mausweg koennen Sie folgendes Einstellen:
  27.  
  28.   - die Zeitspanne, nach der der Mauspfeil verschwinden soll
  29.  
  30.   - eine Anzahl von Tastendrücken, nach denen der Mauspfeil verschwin-
  31.     den soll
  32.  
  33.   - eine Zeit, nach der der Mauspfeil wieder verschwinden soll
  34.  
  35.   - eine Tastenkombination, mit der das Fenster von Mausweg geöffnet
  36.     wird
  37.  
  38.   - die Priorität von Mausweg innerhalb der Liste der Commodities
  39.  
  40.   - ob beim Start von Mausweg sofort das Fenster geöffnet werden soll
  41.  
  42. Eine genaue Erläuterung finden Sie weiter unten.
  43.  
  44.  
  45. Systemanforderungen:
  46. --------------------
  47. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  48. 37.*, sowie die commodities.library ab Version 37.*.
  49. Bitte überprüfen Sie dies:
  50. Rufen  Sie  im  Menü  der  Workbench  unter  "Workbench" den Menüpunkt
  51. "About" auf. Sie bekommen eine Meldung folgender Art:
  52.  
  53.     Kickstart Version ww.xxx
  54.     Workbench Version yy.zzz
  55.  
  56. Wenn  Sie  dieses  Menü und den Menüpunkt nicht finden, dann haben Sie
  57. ein  Betriebssystem  vor  Version  2.0.  Unter diesen Versionen ist es
  58. nicht  möglich,  Mausweg  zu  benutzen.  Bekommen Sie eine Meldung der
  59. obigen  Art, so vergewissern Sie sich bitte, daß dort für ww und yy 37
  60. oder höher steht.
  61.  
  62.  
  63. Und so startet man ein Commodity:
  64. ---------------------------------
  65. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  66. starten:  von der Workbench oder von der Shell aus.
  67.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  68. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  69. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  70. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  71. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  72. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  73. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  74. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  75. Commodity ändern können, wird später beschrieben.
  76.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  77. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity sein
  78. Fenster  öffnet.   Da  es  nicht  sinnvoll  wäre  Mausweg  zweimal zur
  79. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.  Wenn Sie
  80. die   Tool-Types  in  irgendeiner  Weise  verändern,  nachdem  Mausweg
  81. gestartet  wurde,  wird  ihm  diese Veränderung nicht mitgeteilt.  Sie
  82. müssen ein bereits laufendes Mausweg verlassen und neu starten.
  83.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  84. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  85. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  86. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  87. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  88. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  89. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  90. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  91. ein ?  als ersten Parameter angeben:
  92.  
  93.                               Mausweg ?
  94.  
  95. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  96. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  97. erreicht  man  wiederum, daß es sein Fenster öffnet.  Dabei wird keine
  98. der angegebenen Befehlsoptionen berücksichtigt.
  99.  
  100.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  101. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  102. einfügen:
  103.  
  104.                        <Pfad>Mausweg <Optionen>
  105.  
  106. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  107. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  108. anzugeben.   Folgendes  Beispiel  startet  Mausweg,  wenn  es  sich im
  109. Schubladen Tools der Boot-Diskette befindet, so  daß der der Mauspfeil
  110. nach fünf Minuten verschwindet:
  111.  
  112.                        Tools/Mausweg SEKUNDEN=5
  113.  
  114.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  115. starten,  ist,  das  Icon  von Mausweg in den Schubladen WBStartup der
  116. Boot-Diskette   (Workbench)   zu   verschieben.   Das  Commodity  wird
  117. dann   bei   jedem   Boot-Vorgang  gestartet,  als  hätten  Sie  einen
  118. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  119. das Tool-Type DONOTWAIT ergänzen.
  120.  
  121.  
  122. Benutzung von Exchange:
  123. -----------------------
  124. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  125. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  126. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  127. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  128. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  129. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  130. Titel, Beschreibung und Status angezeigt.
  131.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  132. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  133. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  134. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  135. "Show" öffnen lassen und mit "Hide" schließen lassen.
  136.  
  137.  
  138.                        Veränderbare Parameter:
  139.                        -----------------------
  140.  
  141. CX_Priority:
  142. ------------
  143. Mit dem Tool-Type oder der Befehlsoption CX_PRIORITY=<Zahl> können Sie
  144. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  145. bestimmen.  Setzen Sie für <Zahl> bitte einen dezimalen Wert ein.  Die
  146. voreingestellte  Priorität  ist  0.   Es  sollte nicht notwendig sein,
  147. diese Option zu benutzen.
  148.  
  149. Sekunden:
  150. ---------
  151. Mit  der  Befehlsoption bzw.  dem Tool-Type Sekunden=<Zahl> können Sie
  152. die   Sekunden   einstellen,   die   seit   der  letzten  Mausbewegung
  153. verstreichen   müssen,   damit  der  Mauspfeil  verschwindet.   <Zahl>
  154. ersetzen  Sie  bitte durch einen positiven dezimalen Wert.  Sekunden=0
  155. schaltet diese Option aus.  Voreingestellt sind 3 Sekunden.
  156.     Wenn Sie Mausweg bereits gestartet haben, so können Sie die Anzahl
  157. der  Sekunden  auch  in einem Fenster einstellen, das Sie mit Exchange
  158. öffnen  können.   Starten  Sie  Exchange, wählen Sie aus der Liste der
  159. Commodities  Mausweg,  und drücken Sie den "Show" Schalter.  Jetzt hat
  160. sich  das  Fenster von Mausweg geöffnet.  Hier können Sie die Sekunden
  161. ändern,  das  Fenster wieder verschwinden lassen mit "Verstecken" oder
  162. Mausweg beenden mit "Beenden".
  163.  
  164. Tastendruecke:
  165. --------------
  166. Mit  der Befehlsoption  bzw. dem Tool-Type TASTENDRUECKE=<Zahl> können
  167. Sie  einstellen, nach wieviel Tastendrücken der Mauspfeil verschwinden
  168. soll.   Wählen  Sie  hierfür  z.B.  5, so verschwindet  der Mauspfeil,
  169. nachdem sie fünf mal eine Taste losgelassen haben.  Die Betonung liegt
  170. hierbei  auf  Losgelassen, nur dieses zählt.  TASTEBDRUECKE=0 schaltet
  171. diese Option aus.  Voreingestellt ist 5.  Diese Option können Sie auch
  172. im Fenster von Mausweg ändern.
  173.  
  174. Wiederholung:
  175. -------------
  176. Mit  der  Befehlsoption bzw.  dem Tool-Type WIEDERHOLUNG=<Zahl> können
  177. Sie   einstellen,  nach  wie  vielen  Sekunden  der  Mauspfeil  wieder
  178. verschwinden  soll.   Wurde  der  Mauspfeil von Mausweg weggemacht, so
  179. kann  er  wieder erscheinen, indem ein anderes Fenster aktiviert wird,
  180. ohne  dazu die Maus zu bewegen, oder ein anderer Mauspfeil installiert
  181. wird.   Mausweg kann dieses leider nicht feststellen und befindet sich
  182. in  dem  Irrtum,  der Mauspfeil wäre versteckt.  Als Lösung für dieses
  183. Problem  wird  einfach  der  Mauspfeil,  wenn  er  einmal  von Mausweg
  184. weggenommen wurde, nach einer bestimmten Zeit wieder weggenommen, egal
  185. ob er inzwischen wieder sichtbar war oder nicht.  Für diese Zeitspanne
  186. sind  2  Sekunden  voreingestellt.   Da  dieser  Mechanismus natürlich
  187. Rechenzeit   kostet,   können  Sie  mit  WIEDERHOLUNG=0  diese  Option
  188. ausschalten,  wenn  es  Sie  nicht  stört,  ab  und zu mal die Maus zu
  189. bewegen,  um  den  Mauspfeil dann wieder verschwinden zu lassen.  Eine
  190. Erhöhung dieser Zeitspanne spart natürlich auch Rechenzeit ein.  Diese
  191. Option  können  Sie  derzeit  nur beim Start von Mausweg per Tool-Type
  192. oder Befehlszeilenoption bestimmen.
  193.  
  194. CX_Popkey:
  195. ----------
  196. Mit  CX_Popkey=<Zeichenkette> können Sie ein Tastaturkürzel bestimmen,
  197. mit dem Sie das Fenster von Mausweg öffnen können.  Bitte ersetzen Sie
  198. <Zeichenkette>  durch  eine Eingabebeschreibung, wie sie unten erklärt
  199. wird.   Wenn  Sie  diese  Option  weglassen,  wird kein Tastaturkürzel
  200. installiert. Voreingestellt ist "kein Kürzel".
  201.  
  202. Beispiele:
  203.  
  204.     CX_POPKEY=f1                (F1 öffnet das Fenster)
  205.     "CX_POPKEY=lshift f1"       (linke Shift-Taste und F1)
  206.     "CX_POPKEY=alt m"           (eine Alt-Taste und die Taste M)
  207.  
  208. CX_Popup:
  209. ---------
  210. Mit  CX_POPUP=JA|NEIN  können Sie bestimmen, ob beim Start von Mausweg
  211. dessen  Fenster  geöffnet  werden  soll.   JA|NEIN  heißt,  Sie können
  212. entweder  JA oder NEIN einsetzen, aber nichts anderes.  Voreingestellt
  213. ist NEIN.
  214.  
  215.  
  216.                         Eingabebeschreibungen
  217.                         ---------------------
  218.                      (input description strings)
  219.  
  220. Mit   Eingabebeschreibungen  können  Sie  jede  Tastenkombination  der
  221. Tastatur  und  der  Maus  beschreiben, z.B.  das Drücken der Taste F1,
  222. Shift-F1  oder  Alt-F1  oder das Drücken der linken Maustaste zusammen
  223. mit Alt etc.  Darueberhinaus sind einige andere Ereignisse abfragbar.
  224.  
  225. Eingabebeschreibungen haben folgendes Muster:
  226.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  227.  
  228. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  229.  
  230. class   ("Klasse") ist einer der folgenden Ausdrücke:
  231.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  232.         diskremoved, diskinserted.
  233.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  234.  
  235. qual    ("Qualifizierer") ist einer der folgenden Ausdrücke:
  236.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  237.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  238.         relativemouse
  239.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  240.         als irrelevant angenommen werden soll.
  241.  
  242. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  243.         shift bedeutet linke oder rechte Shift-Taste
  244.         caps bedeutet Shift oder Caps-Lock
  245.         alt bedeutet linke oder rechte Alt-Taste
  246.  
  247. upstroke (wörtlich "upstroke")
  248.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  249.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  250.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  251.         voran, so zählt beides.
  252.  
  253. highmap ist einer der folgenden Ausdrücke:
  254.         comma, space, backspace, tab, enter, return, esc, del, up,
  255.         down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9,
  256.         f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  257.  
  258. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  259.         Taste
  260.  
  261.  
  262. Noch einige Beispiele:
  263. ----------------------
  264.  
  265.     Mausweg sekunden=10
  266.     Mausweg sekunden=5 "cx_popkey=ctrl 1" cx_popup=ja
  267.     Mausweg sekunden=15 "cx_popkey=help"
  268.     Mausweg sekunden=15 tastendruecke=20 "cx_popkey=lalt m"
  269.     Mausweg sekunden=5 tastendruecke=2 wiederholung=1
  270.  
  271.  
  272. Versionengeschichte:
  273. --------------------
  274. V1.20   kleiner Fehler wurde behoben
  275. V1.19   ein paar kleine Veränderungen, um das Programm kleiner zu machen
  276. V1.18   Fenster wird nun auf dem vordersten Screen geöffnet, sofern
  277.         dieser öffentlich ist. Ist er dies nicht, wird das Fenster
  278.         wie gehabt auf dem default public screen geöffnet.
  279.         Enforcer-Hit bei Speichermangel wurde entfernt.
  280. V1.17   interne Änderungen
  281. V1.16   interne Änderungen
  282. V1.15   "Maus-Blanking"-Methode wurde gewechselt; leider habe ich
  283.         immer noch nicht DIE "saubere" Methode gefunden; Blanken
  284.         nach einer Anzahl von Tastendücken wurde hinzugefügt;
  285.         viele kleinere Änderungen
  286. V1.14   SAS/Cs cback.o wurde für 68040-Kompatibilität von mir nach
  287.         Instruktionen von Michael Sinz geändert; Mausweg wurde mit
  288.         diesem cback.o neu gebunden
  289.  
  290.  
  291.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  292.      -----------------------------------------------------------
  293.                             Geschenke an:
  294.                              ------------
  295.  
  296.                             Stefan Sticht
  297.                           Bibereckerweg 40a
  298.                            D-8390 Passau 18
  299.                                  FRG
  300.  
  301. oder (besser) an eine der folgenden EMail-Adressen:
  302. sticht@edith.deg.sub.org
  303. Fido-Netz: Stefan Sticht (2:246/200.4)
  304.  
  305. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  306. Diese erhalten Sie z.B. mit dem Befehl "Version":
  307.                      Version [<path>]<commodity>
  308.  
  309.